MBMView Version 2.10
Copyright: Lieuwe de Vries 1997-1998
====================================

MBMView is now shareware. If you use the program for more than a week,
please register. The program is fully working so I trust you register
when you keep using it... 

New in version 2.10:
1. Support for reading GIF files.
2. New registration numbers required for this version. Registered users will have receive one already.
3. New icon and helpfile thanks to Phil Creed.

New in version 2.00:
1. Support for reading JPG and BMP files. (Using an OPX)
2. Support for reading SpritEdit files.
3. Program is now shareware...

New in version 1.30:
1. Save bitmap as Sketch file.
2. Mosaic from all supported bitmaps in directory
3. New button in bottom toolbar which load the next
   supported file in the current directory.
4. A number of other small enhancements.

New in version 1.21:
1. Removed all the (stupid) bugs from version 1.20

New in version 1.20:
1. Changed menu structure.
2. Create mosaic from all bitmaps in current file.
3. Extra error checking.


What is MBMView
---------------
MBMView is a bitmap viewer which views all bitmap types of the Series 5:
1. 'Normal' and 'multi' MBM files.
2. ROM MBM files(Only from ROM).
3. Sketch files.
4. AIF files (which contain the icons)
5. JPG files.
6. BMP/GIF files.
7. SpritEdit files.
8. Photo5 files.
9. Create mosaic of all bitmaps in one file or directory

Once loaded and on screen you can save them as a normal MBM file or as
a Sketch file. You can create/add to multi MBM files. You can even
convert ROM multi MBM files to normal MBM files.

You can scroll the image using the keyboard, pen (just drag it around) or
on screen buttons.

It shows bitmaps in 2, 4 or 16 color mode.

MBM files are saved in such a way that they can be converted on the PC using
BMCONV.EXE. You can patch existing files with the same result.


Installing MBMView:
-------------------
1. Copy MBMView.opx to a \System\Opx directory.
2. Use Stdlib.sis to install estdlib.dll on your Series 5 (preferred) 
   OR
   copy ESTDLIB.dll to a \System\Libs directory.
3. Create a directory \System\Apps\MBMView and copy the rest of the
   files in this directory.

To do this you need access to the system directory. You can set this in
the system preferences.


Registering MBMView 2.10:
--------------------------
1. Register on CompuServe (GO SWREG, ID=16986) .
2. Register on Regnet (www.swregnet.com, ID=4245). 
3. Register on RegSoft (www.regsoft.com, ID=2076). 

4. Send cash to me at:
   L. de Vries
   Taling 11
   9101 ZG Dokkum
   Netherlands.
   Only use currencies: USD$ 25, NLG 50
5. Send a EuroCheque in Dutch currency (NLG) (No other cheques/currencies please)
   Use the address under 4.


Using MBMView:
--------------
The bottom button bar:
The left 2 buttons (with small info window) are only for multi MBM files.
The third button loads the next supported file in the current directory.
The 4 buttons on the right are for scrolling the bitmap. You can 
move the bitmap with the pen as well.


Menu options:
  File
    Open
      Open bitmap file
    Next
    	Load next supported file (MBM, AIF, Sketch) in current directory
    Save
      Current bitmap
        Save bitmap to file. If file does not exist, one will be created.
        If file exists, the bitmap will be added to the file.
      All bitmaps
        All bitmaps in the current file will be saved to file. If file does
        not exist, the file will be created. If it does exist, the bitmaps
        will be added to the file
      As Sketch
        Saves the current bitmap as a Sketch file. Sketch files can only contain
        1 bitmap.
    Patch
      Patch current file so it can be used with BMCONV.EXE
    Create from file list
      Takes a plain text file as input and makes a MBM files. The first line of the text file
      should contain the file to be created. On each of the following lines contains a
      bitmap file (of all supported types). Only the first bitmap of each file named in
      the text file is copied.
    Close
    	Close the current bitmap and free the memory
    Exit
      Leave the program
  Bitmap
     Replace
        Replaces current bitmap.
     Delete
        Deletes current bitmap from file. (You cannot delete the last one)
     Insert
        Inserts a bitmap at the current location in the file.
    Change color mode
      Changes the color mode of the current bitmap. Save it to keep the changes.
      Especially handy in decreasing color depth of bitmaps.
    Info
      Show info on current bitmap.
    Position
      Center
        Center current bitmap on the screen
      Top left
        Place bitmap in top left corner of the screen
  View
    Show toolbar
      If checked a toolbar will be shown at the right hand side of the screen
    Show bottom toolbar
      If checked a toolbar will be shown at the bottom of the screen
    Default directory
      Goto default directory (home) and load first supported file.
    Mosaic
      Create mosaic of all bitmaps in current file. Can be saved.
    Bitmap #
      Next
        Show next bitmap in file if it is a multi MBM file
      Previous
        Show previous bitmap in file if it's a multi MBM file
      Jump to
        Show dialog to jump to any bitmap in file if it's a multi MBM file
  Tools
    View preferences
      Set program preferences
    Set default directory
      Set current directory as the default directory.
      (A bitmap should be loaded to do this)
    Help
      Switch to help file
    About
      Program information


Some interesting information about MBM files on the Series 5:
-------------------------------------------------------------
While analyzing MBM files on the Series 5 I stumbled across some interesting
things:

There are 3 quite different types of bitmap files on the series5. Each with
its own (quite) distinct format:

1. ROM Image files: These are MBM files on the 'Z' drive containing one
   or more bitmaps. They are used by the built in applications. They can be
	loaded using 'gLoadBit' in OPL as long as they are on the 'Z' drive.
	If you copy them to the internal drive (Drive C) they cannot be 
        accessed...
   You can however use MBMView to save such a file as a normal MBM file.
2. Normal MBM files: Files containing 1 or more bitmaps. Such files are
   supplied with most (shareware/freeware) programs, containing images etc.
   You can create single MBM files in OPL using 'gSaveBit'. If you copy
   this file to the PC, it cannot be converted using BMCONV.EXE!
   MBMView patches these files when saving, so they CAN be converted.
3. Sketch files: Files created using the built in Sketch application. These
   file always contain just 1 bitmap and are always in 4 colors.
   MBMView reads these files. They can then be saved as normal MBM files.
   You can save 16 color images to Sketch format, but Sketch will reduce
   these to 4 when loading.
4. AIF files : There seem to be a lot of different AIF files. The ones I've seen
   can be read. It might be there is a type MBMView currently does not support.
   Only the icons are read.

Viewing the bitmaps on screen:
Painting bitmaps on screen can be slow if the screen mode differs from
the bitmap mode. So showing a 16 color bitmap while the screen is in 4 color
mode will be slow because of color conversions. MBMView has an option (set in
the preferences) to automatically change the screen mode so that is matches
the bitmap mode.


Thanks to:
----------
The Independent JPEG Group's JPEG source code (version 6a) which was used
as a base for this software (JPG/BMP reading)


Contacting the author
---------------------
If you find bugs or have suggestions, mail me at:
platodva@csi.com
New versions will be available on my homepage:
http://ourworld.compuserve.com/homepages/platodva/psion.htm


Legal stuff:
------------
Notice to users: Carefully read the following legal agreement. Use of the software provided with this agreement (the "software") constitutes your acceptance of these terms. If you do not agree to the terms of this agreement, promptly remove the software together with all copies from your computer. User's use of this Software is conditioned upon compliance by user with the terms of this agreement.

The software is protected by copyright law and international treaty provisions. You acknowledge that no title to the intellectual property in the software is transferred to you. You further acknowledge that title and full ownership rights to the software will remain the exclusive property of L. de Vries, and you will not acquire any rights to the software except as expressly set forth in this license. You agree that any copies of the software will contain the same proprietary notices which appear on and in the software.

We do not warrant that the software is error free. We disclaim all other warranties with respect to the software, either express or implied, including, but not limited to, implied warranties of merchantability, fitness for a particular purpose and non-infringement of third party rights.

There is no liability for consequential damages. In no event shall we or our suppliers be liable to you for any consequential, special, incidental or indirect damages of any kind arising out of the delivery, performance or use of the software, even if we have been advised of the possibility of such damages. In no event will our liability for any claim, whether in contract, or any other theory of liability, exceed the license fee paid by you.
